# 附录 D · 版本快照与取证方法

## 冻结版本

- 产品：WorkBuddy 5.3.13，build 20fd9da5c9a0cac41feb61b133f7bce4fe183a89（本机安装版本，约 2026-08-13；官方 Changelog 两轮抓取存在 5.3.12/5.3.13 差异，以本机 renderer-version.json 为准）
- 声明环境：macOS（Apple Silicon，darwin 25.5.0），本机真实账户
- 取证窗口：2026-08-15；27 项关键文件 SHA-256 指纹存本书研究档案（local-snapshot-manifest.json）

## 核对本书是否仍适用于你的版本

```
cat ~/.workbuddy/app/renderer-version.json
```

版本一致 → 机制描述按书为准；版本更新 → 先查官方更新日志中涉及以下关键词的条目：提示词、模板、专家、插件、记忆、权限、沙箱、MCP。命中条目对应章节按「文件现状」重新核对（每章动手环节的命令即核对工具）。

## 读者可复用的取证方法

1. **结构取证**：`find  -maxdepth 2` 建立地图；`ls -lt` 找最新变化。
2. **行为取证**：会话 JSONL 逐事件分析（第 10 章 grep 方法）；`parentId` 链回溯决策依据。
3. **注入取证**：会话首条消息找 system-reminder 包裹；专家会话找 expert_selection 标签。
4. **指纹冻结**：对关键文件记 sha256，更新前后对比即知变化面：

```
shasum -a 256 ~/.workbuddy/settings.json
```

1. **反证习惯**：任何机制断言，找一个「若断言为假则应出现」的反例样本；找不到才算验证完成。

## 证据分层的公开标注

全书断言按五层标注：官方（已取证正文）、源码（本机文件实测）、实测（声明环境的主动验证操作，含文件比对与运行时观测）、社区（第三方拆解，仅交叉验证）、推断（注明推理链与反证）。未标注的常识性表述不构成机制断言。